TypeScript: إتقان الأنواع الحرفية للقالب والأنواع الشرطية

مثال دولي: معالجة تنسيقات التواريخ المختلفة

تستخدم مناطق مختلفة من العالم تنسيقات تواريخ مختلفة. يمكنك استخدام الأنواع الشرطية لمعالجة هذه الاختلافات.

type DateFormat = "YYYY-MM-DD" | "MM/DD/YYYY" | "DD.MM.YYYY";

type ParseDate = T extends "YYYY-MM-DD"
  ? { year: number; month: number; day: number; format: "YYYY-MM-DD" }
  : T extends "MM/DD/YYYY"
  ? { month: number; day: number; year: number; format: "MM/DD/YYYY" }
  : T extends "DD.MM.YYYY"
  ? { day: number; month: number; year: number; format: "DD.MM.YYYY" }
  : never;


function parseDate(dateString: string, format: T): ParseDate {
  // (سيقوم التنفيذ بمعالجة تنسيقات التواريخ المختلفة)
  if (format === "YYYY-MM-DD") {
    const [year, month, day] = dateString.split("-").map(Number);
    return { year, month, day, format } as ParseDate;
  } else if (format === "MM/DD/YYYY") {
    const [month, day, year] = dateString.split("/").map(Number);
    return { month, day, year, format } as ParseDate;
  } else if (format === "DD.MM.YYYY") {
    const [day, month, year] = dateString.split(".").map(Number);
    return { day, month, year, format } as ParseDate;
  } else {
    throw new Error("تنسيق تاريخ غير صالح");
  }
}

const parsedDateISO = parseDate("2023-10-27", "YYYY-MM-DD"); // النوع: { year: number; month: number; day: number; format: "YYYY-MM-DD"; }
const parsedDateUS = parseDate("10/27/2023", "MM/DD/YYYY"); // النوع: { month: number; day: number; year: number; format: "MM/DD/YYYY"; }
const parsedDateEU = parseDate("27.10.2023", "DD.MM.YYYY"); // النوع: { day: number; month: number; year: number; format: "DD.MM.YYYY"; }


console.log(parsedDateISO.year); // الوصول إلى السنة مع العلم أنها ستكون موجودة

يستخدم هذا المثال الأنواع الشرطية لتعريف دوال تحليل التواريخ المختلفة بناءً على تنسيق تاريخ التاريخ المحدد. يضمن النوع ParseDate أن الكائن المُرجع يحتوي على الخصائص الصحيحة بناءً على التنسيق.

الجمع بين أنواع الحروف للقالب والأنواع الشرطية

تأتي القوة الحقيقية عندما تجمع بين أنواع الحروف للقالب والأنواع الشرطية. هذا يسمح بتعاملات أنواع قوية بشكل لا يصدق.

type EventName = `on${Capitalize}`;

type ExtractEventPayload = T extends EventName 
  ? { type: T; payload: any }  // مبسط للتوضيح
  : never;


type ClickEvent = EventName<"click">;  // "onClick"
type MouseOverEvent = EventName<"mouseOver">;  // "onMouseOver"


// مثال لدالة تأخذ نوعًا
function processEvent(event: T): ExtractEventPayload {
    // في التنفيذ الحقيقي، سنقوم فعليًا بإرسال الحدث.
    console.log(`Processing event ${event}`);

    // في التنفيذ الحقيقي، ستستند الحمولة إلى نوع الحدث.
    return { type: event, payload: {} } as ExtractEventPayload;
}

// لاحظ أن أنواع الإرجاع محددة للغاية:
const clickEvent = processEvent("onClick");  //  { type: "onClick"; payload: any; }
const mouseOverEvent = processEvent("onMouseOver"); //  { type: "onMouseOver"; payload: any; }

// إذا استخدمت سلاسل نصية أخرى، تحصل على never:
// const someOtherEvent = processEvent("someOtherEvent"); // النوع هو `never`

أفضل الممارسات والاعتبارات

• اجعلها بسيطة: على الرغم من قوتها، يمكن أن تصبح هذه الأنواع المتقدمة معقدة بسرعة. اسعَ لتحقيق الوضوح وقابلية الصيانة.
• اختبر بشكل شامل: تأكد من أن تعريفات الأنواع الخاصة بك تتصرف كما هو متوقع عن طريق كتابة اختبارات وحدات شاملة.
• وثق التعليمات البرمجية الخاصة بك: وثق بوضوح الغرض والسلوك الخاص بالأنواع المتقدمة لتحسين قابلية قراءة التعليمات البرمجية.
• ضع في اعتبارك الأداء: يمكن أن يؤثر الاستخدام المفرط للأنواع المتقدمة على وقت الترجمة. قم بقياس التعليمات البرمجية الخاصة بك وتحسينها عند الضرورة.